POSITION.TXT, for use with OLE Automation with Word for Windows

-----------------------------------------------------------------------------
The information in the article applies to:

- The Standard and Professional Editions of Microsoft Visual Basic, version 
  3.0 for Windows.
- Microsoft Word, version 6.0 for Windows.
-----------------------------------------------------------------------------

SUMMARY
=======

The file POSITION.TXT is provided for users of Microsoft Visual Basic, version
3.0 who want to access WordBasic in Word, version 6.0 through OLE Automation.
Currently this file is being shipped with the Word Development Kit (WDK).

This file provides a listing of WordBasic functions and all their required
parameters in the proper order (which the on-line help in Word 6.0 does not)

This document is also available as an on-line help file (POSITION.HLP).  This
help file can be downloaded as a self-extracting file POSITION.EXE from the  
Microsoft Software Library (MSL) accessible from the following services:

	- Microsoft Software Library (MSL) on CompuServe (GO MSL).

	- Microsoft Software Library on Internet(ftp.microsoft.com cd softlib)

	- Microsoft Download Service (206)936-MSDL.

MORE INFORMATION
================

WordBasic statements or functions in WinWord 6.0 can take named arguments.
Visual Basic version 3.0 does not support named arguments, which means that
when a Visual Basic 3.0 application sends WordBasic commands through OLE  
Automation, it must specify ALL named WordBasic arguments in the proper  
position. Where the same function call in WordBasic may only require some of  
the parameters and using named arguments, they could be provided in any order.

For most WordBasic statements the positioning of the arguments is documented
in the WordBasic Help topics or printed reference entries for those  
statements. However, there are some statements whose documents arguments are  
not listed in order or that have arguments that are irrelevant or that have  
no effect. These arguments are not documented in WordBasic Help or in the  
printed reference. 

For example, the InsertIndex statement corresponds to the Index tab in the
Index and Tables dialog box. The InsertIndex statement takes a number of  
arguments that have to do with other tabs in the dialog box, such the Table  
of Contents tab. Since these arguments are irrelevant to inserting an index,  
they are ignored and therefore not documented in WordBasic Help or in the  
printed reference. 

However, the Visual Basic version 3.0 OLE Automation programmer needs to  
beaware of these arguments so that he or she can correctly specify arguments  
by position.